###User Defined Function###
_WinAPI_DrawText

###Description###
Zeichnet formatierten Text in das angegebene Rechteck

###Syntax###
#include <WinAPI.au3>
_WinAPI_DrawText ( $hDC, $sText, ByRef $tRect, $iFlags )


###Parameters###
@@ParamTable@@
$hDC
	Handle zu einem Gertekontext
$sText
	Die zu zeichnenden Strings
$tRect
	$tagRECT Struktur, die das Rechteck enthlt, in das der Text gezeichnet werden soll
$iFlags
	Legt die Methode der Textformatierung fest:
	$DT_BOTTOM - Setzt den Text untenbndig im Rechteck
	$DT_CALCRECT - Ermittelt die Breite und Hhe des Rechtecks
	$DT_CENTER - Zentriert den Text horizontal im Rechteck
	$DT_EDITCONTROL - Dupliziert die Textanzeige-Eigenschaften eines mehrzeiligen Edit-Controls
	$DT_END_ELLIPSIS - Ersetzt Teile des Strings notfalls mit Auslassungszeichen (...)
	$DT_EXPANDTABS - Expandiert Tab Druckzeichen
	$DT_EXTERNALLEADING - Bercksichtigt bei mehrzeiligem Text den Durchschuss in der Zeichenhhe
	$DT_HIDEPREFIX - Ignoriert den Kaufmannsund-Prfix (& - Unterstreichung) im Text.
	  Der darauf folgende Buchstabe wird nicht unterstrichen, andere Mnemonik-Prfixe werden aber weiterhin verarbeitet.
	$DT_INTERNAL - Benutzt den Systemzeichensatz, um die Schriftmae zu berechnen
	$DT_LEFT - Text ist linksbndig
	$DT_MODIFYSTRING - Modifiziert die Strings, um den anzuzeigenden Text anzupassen
	$DT_NOCLIP - Unterdrckt das Abschneiden von Text bzw. Zeichenteilen an den Grenzen des Rechtecks
	$DT_NOFULLWIDTHCHARBREAK - Verhindert Zeilenumbrche bei DBCS (doppelt-lange Strings), dadurch gilt die gleiche Regel wie fr Strings einfacher Lnge.
	  Dies kann zum Beispiel genutzt werden, um unter einem koreanischen Windows die Lesbarkeit der Icon-Beschriftungen zu verbessern.
	  Dieser Wert hat keinen Einfluss, wenn nicht auch $DT_WORDBREAK angegeben wird.
	$DT_NOPREFIX - Schaltet das Verarbeiten aller Prfixzeichen ab (z.B. & fr Unterstreichung)
	$DT_PATH_ELLIPSIS - Ersetzt im angezeigten Text so viele Zeichen in der Mitte des Strings durch Auslassungszeichen (...), bis das Ergebnis in das angegebene Rechteck passt.
	  Wenn der String Backslash-Zeichen (\) enthlt, behlt $DT_PATH_ELLIPSIS so viele Zeichen wie mglich nach dem letzten Backslash bei.
	  der String wird nicht verndert, wenn nicht auch $DT_MODIFYSTRING angegeben wird.
	$DT_PREFIXONLY - Zeichnet nur die Unterstreichung an der Position eines Zeichens, das auf einen Kaufmannsund-Prfix (&) folgt.
	  Es wird kein weiteres Zeichen des Strings ausgegeben.
	$DT_RIGHT - Text ist rechtsbndig
	$DT_RTLREADING - Rechts-nach-Links Ausrichtung des Textes
	$DT_SINGLELINE - Zeigt den Text einzeilig an
	$DT_TABSTOP - Setzt die Tabstopps. Die Bits 15-8 der $iFlags legen die Anzahl der Druckzeichen in einem Tab fest.
	$DT_TOP - Setzt den Text obenbndig im Rechteck (nur bei einzeiligem Text)
	$DT_VCENTER - Zentriert den Text vertikal (nur bei einzeiligem Text)
	$DT_WORDBREAK - Bricht Wrter in Zeilen um
	$DT_WORD_ELLIPSIS - Beschneidet alle Wrter, die nicht in das angegebene Rechteck passen und fgt dafr Auslassungszeichen an
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Die Hhe des Textes
Fehler:	0
@@End@@


###Remarks###
Die DrawText-Funktion benutzt zum Zeichnen die im Gertekontext gewhlte Schriftart, Textfarbe und Hintergrundfarbe.
Sofern nicht das $DT_NOCLIP-Format verwendet wird, beschneidet DrawText den Text, sodass dieser nicht auerhalb des
angegebenen Rechtecks erscheint. Bei allen Formatierungen wird angenommen, dass es sich um mehrzeiligen Text handelt,
auer wenn $DT_SINGLELINE angegeben wird. Ist die gewhlte Schriftart zu gro, versucht DrawText nicht, diese durch
eine kleinere zu ersetzen.

Oben gennante Konstanten bentigen #include <WindowsConstants.au3>


###Related###
$tagRECT, _WinAPI_GetBkMode, _WinAPI_SetBkMode


###See Also###
@@MsdnLink@@ DrawText


###Example###
@@IncludeExample@@
